Contexto global

PutFilesToServerAsync

Variante de sintaxis: Por descripciones de archivos a colocar

Sintaxis:

PutFilesToServerAsync(<CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <TransferredFileDescriptions>, <FormUniqueID>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción de un procedimiento que se llamará varias veces a medida que se colocan los archivos. El número de llamadas y el tiempo de llamada no están estrictamente definidos. La notificación se llama con los siguientes parámetros:

• <FileToPut> – tipo: FileRef. Referencia al archivo colocado en el almacenamiento temporal.
• <Placed> – tipo: Número. Porcentaje de la parte colocada del archivo actual.
• <CancelPuttingFile> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación del archivo en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <TotalPlaced> – tipo: Número. Porcentaje de la parte colocada de todos los archivos.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación de todos los archivos en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacenen los archivos. La notificación se llama con los siguientes parámetros:

• <FilesToPut> – tipo: Array. Matriz de elementos del tipo FileRef que están listos para ser colocados en un almacenamiento temporal.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece este parámetro en Verdadero en el modo del procedimiento de controlador, se cancelará la colocación de todos los archivos (en este caso, no se llamará a otras notificaciones). El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: Array.
Una matriz de objetos TransferableFileDescription. Cada elemento de la matriz debe contener una ruta no vacía al archivo en el disco duro. La dirección del almacenamiento temporal donde se colocará un archivo se puede dejar en blanco. En este caso, se crea un nuevo archivo.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente.
El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto de formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Coloca los archivos especificados como rutas en el disco duro desde el sistema de archivos local en el almacenamiento temporal.
La extensión de operación de archivo es requerida en el cliente web.
El controlador <CallbackDescriptionOnProgress> solo se llama dos veces en el cliente web: cuando el número total de bytes colocados en el almacenamiento temporal es 0 y cuando es igual al tamaño total de los archivos que se van a colocar.

Variante de sintaxis: Por una cadena de búsqueda

Sintaxis:

PutFilesToServerAsync(<CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <SearchString>, <FormUniqueID>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción de un procedimiento que se llamará varias veces a medida que se colocan los archivos. El número de llamadas y el tiempo de llamada no están estrictamente definidos. La notificación se llama con los siguientes parámetros:

• <FileToPut> – tipo: FileRef. Referencia al archivo colocado en el almacenamiento temporal.
• <Placed> – tipo: Número. Porcentaje de la parte colocada del archivo actual.
• <CancelPuttingFile> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación del archivo en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <TotalPlaced> – tipo: Número. Porcentaje de la parte colocada de todos los archivos.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación de todos los archivos en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacenen los archivos. La notificación se llama con los siguientes parámetros:

• <FilesToPut> – tipo: Array. Matriz de elementos del tipo FileRef que están listos para ser colocados en un almacenamiento temporal.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece este parámetro en Verdadero en el modo del procedimiento de controlador, se cancelará la colocación de todos los archivos (en este caso, no se llamará a otras notificaciones). El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: Cadena.
La cadena debe ser una ruta al directorio donde se realiza la búsqueda. El directorio puede estar ubicado tanto en LAN como en un servidor FTP. Al utilizar este esquema, especifique barras diagonales (/) en lugar de barras invertidas (\) en las direcciones.
Se permite especificar el nombre completo del archivo (ruta + nombre).

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente.
El archivo se coloca en un almacenamiento temporal y se elimina automáticamente después de que se elimina el objeto de formulario de la aplicación cliente.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Coloca los archivos encontrados por la cadena de búsqueda desde el sistema de archivos local en el almacenamiento temporal.
La extensión de operación de archivo es requerida en el cliente web.
El controlador <CallbackDescriptionOnProgress> solo se llama dos veces en el cliente web: cuando el número total de bytes colocados en el almacenamiento temporal es 0 y cuando es igual al tamaño total de los archivos que se van a colocar.

Variante de sintaxis: Por enlaces a archivos

Sintaxis:

PutFilesToServerAsync(<CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <FileRefs>, <FormUniqueID>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción de un procedimiento que se llamará varias veces a medida que se colocan los archivos. El número de llamadas y el tiempo de llamada no están estrictamente definidos. La notificación se llama con los siguientes parámetros:

• <FileToPut> – tipo: FileRef. Referencia al archivo colocado en el almacenamiento temporal.
• <Placed> – tipo: Número. Porcentaje de la parte colocada del archivo actual.
• <CancelPuttingFile> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación del archivo en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <TotalPlaced> – tipo: Número. Porcentaje de la parte colocada de todos los archivos.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación de todos los archivos en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – un valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacenen los archivos. La notificación se llama con los siguientes parámetros:

• <FilesToPut> – tipo: Array. Matriz de elementos del tipo FileRef que están listos para ser colocados en un almacenamiento temporal.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece este parámetro en Verdadero en el modo del procedimiento de controlador, se cancelará la colocación de todos los archivos (en este caso, no se llamará a otras notificaciones). El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: Array.
Contiene una matriz de objetos del tipo FileRef.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente.
El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto de formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Coloca los archivos especificados como referencias de archivo desde el sistema de archivos local en el almacenamiento temporal.
La extensión de operación de archivo no es requerida en el cliente web.

Variante de sintaxis: Usando el cuadro de diálogo de selección de archivos

Sintaxis:

PutFilesToServerAsync(<CallbackDescriptionOnProgress>, <CallbackDescriptionBeforeStart>, <DialogParameters>, <FormUniqueID>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción de un procedimiento que se llamará varias veces a medida que se colocan los archivos. El número de llamadas y el tiempo de llamada no están estrictamente definidos. La notificación se llama con los siguientes parámetros:

• <FileToPut> – tipo: FileRef. Referencia al archivo colocado en el almacenamiento temporal.
• <Placed> – tipo: Número. Porcentaje de la parte colocada del archivo actual.
• <CancelPuttingFile> – tipo: Booleano. Indica que se cancela la colocación adicional del archivo en el almacenamiento. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación del archivo en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <TotalPlaced> – tipo: Número. Porcentaje de la parte colocada de todos los archivos.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece el valor del parámetro en Verdadero en el módulo del procedimiento de controlador, se cancelará la colocación de todos los archivos en el almacenamiento. El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – el valor especificado al crear el objeto CallbackDescription.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará antes de que se almacenen los archivos. La notificación se llama con los siguientes parámetros:

• <FilesToPut> – tipo: Array. Matriz de elementos del tipo FileRef que están listos para ser colocados en un almacenamiento temporal.
• <CancelPuttingAllFiles> – tipo:Booleano}. Indica que se cancela la colocación de todos los archivos. Si establece este parámetro en Verdadero en el modo del procedimiento de controlador, se cancelará la colocación de todos los archivos (en este caso, no se llamará a otras notificaciones). El valor predeterminado es Falso. El parámetro devuelto.
• <AdditionalParameters> – un valor especificado al crear el objeto CallbackDescription

}

Tipo: PutFilesDialogParameters.
La estructura que contiene los parámetros del cuadro de diálogo que se mostrará al usuario.

Tipo: UUID.
El UUID del formulario que se puede obtener con la propiedad UUID de un formulario de aplicación cliente.
El archivo se guarda en un almacenamiento temporal y se elimina después de que se elimina el objeto de formulario.
Si omite este parámetro, el valor almacenado se borra después de la siguiente llamada al servidor desde un módulo común, o en una llamada al servidor de contexto o no de contexto desde un formulario, o en una llamada al servidor desde un módulo de comando, o al obtener un formulario.

Descripción de la variante del método:

Muestra el cuadro de diálogo de selección de archivos y coloca los archivos desde el sistema de archivos local en el almacenamiento temporal.
La extensión de operación de archivo no es requerida en el cliente web.

Valor devuelto:

Tipo: Promise.
El resultado de la ejecución de la promesa es una matriz de objetos StoredFileDescription o Undefined si se cancela la colocación en el almacenamiento temporal.

Descripción:

Función asíncrona. Coloca los archivos en el almacenamiento temporal.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Véase también:

Contexto global, método BeginPuttingFiles
Contexto global, método BeginPutFilesToServer
Contexto global, método PutFile
Contexto global, método PutFileToServerAsync
Contexto global, método PutFiles

Disponible desde:

Disponible desde la versión 8.3.18.

---